home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 1 / your choice.zip / your choice / SNDTOOLS / MMM23 / MMM.DOC < prev    next >
Text File  |  1994-01-10  |  14KB  |  439 lines
  1.  
  2.     Multi Media Machine, Version 2.3, Edward C. Willemsen, 1994 (c++).
  3.     ----------------------------------------------------------------------
  4.  
  5.     MMM........:
  6.     ----------------------------------------------------------------------
  7.     MMM stands for Multi Media Machine. Why? Well, simple, MMM can
  8.     easily handle graphical images, sound files and animation files.
  9.     Futhermore, MMM is also able to combine one or more of these features.
  10.  
  11.     Output possibilities can be generated via a wide variety of sound
  12.     reproduction hardware.
  13.  
  14.     Image generation can be accomplished with different types of
  15.     resolutions.
  16.  
  17.     SUPPORTED..:
  18.     ----------------------------------------------------------------------
  19.         - The most common .DL animation methods;
  20.           ( Technical : SMALL : 16, MEDIUM : 4-8-12-16 ).
  21.  
  22.         - every .FLI animation file;
  23.  
  24.         - every .MOD sound-module that fits into free memory;
  25.  
  26.         - .MDI midi-file on SoundBlaster or Adlib;
  27.           ( Technical : version 1, other versions sound poor,
  28.                   but those versions have the .MID extension ).
  29.  
  30.         - .VOC sample-file, RAW versions only;
  31.           ( Technical : uses Creative Labs, Inc. CT-VOICE driver ).
  32.  
  33.         - .CMF sound-file, using the SBFMDRV.COM;
  34.           ( Technical : SBFMDRV.COM is a Creative Labs product ).
  35.  
  36.         - PcPaintbrush formatted .PCX file with 256 colors;
  37.           ( Technical : version 5, 8 bits/pixel ).
  38.  
  39.         - Windows formatted .BMP file with 256 colors;
  40.           ( Technical : not compressed, 8 bits/pixel ).
  41.  
  42.         - every CompuServe formatted .GIF file;
  43.           ( Technical : 87a, 89a, interlaced and non-interlaced ).
  44.  
  45.         - Targa Vision .TGA file with 256 colors;
  46.           ( Technical : methods 0,1,2,3,4,5,6 and 7 ).
  47.  
  48.         - WordPerfect .WPG file with 256 colors;
  49.           ( Technical : version 5.0 and version 5.1 ).
  50.  
  51.         - every ColorRIX .RIX file;
  52.           ( Technical : RIX images, used to be 256 color ).
  53.  
  54.         - MacPaint .MAC file;
  55.           ( Technical : with or without header ).
  56.  
  57.         - Windows .ICO icon-file;
  58.  
  59.     HARDWARE...:
  60.     ----------------------------------------------------------------------
  61.     What you really need is a MCGA/VGA (or higher) graphical card.
  62.     If you're not sure that your graphical card is supporting the
  63.     VESA/SVGA modes, i.e. 640x400x256, 640x480x256 and higher,
  64.     then use the 'info' -> 'check vesa/svga' option, otherwise
  65.     you may incur some damage to your graphical card.
  66.  
  67.     The 'check vesa/svga' option gives you information about all
  68.     the supporting graphical modes. These modes are :
  69.  
  70.          320x 200x256    ; MCGA/VGA
  71.          640x 400x256    ; VESA
  72.          640x 480x256    ; VESA
  73.          800x 600x256    ; VESA
  74.         1024x 768x256    ; VESA
  75.         1280x1024x256    ; VESA, I never met this mode.
  76.  
  77.     The best sound output is given with a SoundBlaster, but you can
  78.     use a Covox, Adlib, Disney Sound Source or even the internal
  79.     bleeper as well.
  80.  
  81.     You can also change the sound source within the program.
  82.     If you're not sure that your SoundBlaster is working or    if
  83.     you don't know that the machine you're working on has one, then
  84.     use the 'info' -> 'check soundblaster' option. After doing
  85.     this, you DON'T have to restart MMM, because of the fact MMM
  86.     already knows that there's a SoundBlaster available.
  87.  
  88.     When you're playing .MOD files, you can increase the quality
  89.     of the sound by changing the mixing speed. This option can be
  90.     found at 'output' -> 'mixing speed'. The default value and
  91.     minimum is 10kHz, the maximum value is 18khz. BUT, increasing
  92.     the mixing speed, decreases the speed of the 'multi' options,
  93.     because of the fact that more CPU power is needed to play the
  94.     sound-module. ( Even the TVision system works slowly, but the
  95.     sound is perfect ! ).
  96.  
  97.             Mixing Speed        |    CPU
  98.             --------------------|---------
  99.             10.000 Hz (default) |    86
  100.             11.000 Hz        |   86
  101.             12.000 Hz        |   286
  102.             13.000 Hz        |   286
  103.             14.000 Hz ( 386 )   |    386*
  104.             15.000 Hz        |    386, fast
  105.             16.000 Hz ( 486 )   |    486
  106.             17.000 Hz        |    486
  107.             18.000 Hz        |    486, fast
  108.  
  109.     *) Use this as default on a 386.
  110.     Switching to a higher mixing speed than possible, slows
  111.     down the playing and could bog the computer.
  112.  
  113.     The option menu's within MMM can be accessed with the keyboard,
  114.     using the highlighted characters, or with a mouse.
  115.  
  116.     HOT KEYS...:
  117.     ----------------------------------------------------------------------
  118.     == Main ==
  119.     
  120.         F1 : Text size - the text mode from 80x25 to 80x45/50
  121.              or from 80x45/50 to 80x25.
  122.  
  123.         F2 : Dos shell - jumps into the dos-shell, from where
  124.              you can return by typing 'exit' on the dos-prompt.
  125.  
  126.         F3 : Change dir... - to change drive and/or directory.
  127.              Use the Alt 'highlighted' keys if you don't have
  128.              a mouse.
  129.  
  130.         F10: For the menu options.
  131.  
  132.     == Play ==
  133.  
  134.      <ctrl> F1 : Play the default dl-animation file.
  135.  
  136.      <ctrl> F2 : Play the default fli-animation file.
  137.  
  138.      <ctrl> F3 : Play the default mod-sound file.
  139.  
  140.      <ctrl> F4 : Play the default mdi-sound file.
  141.  
  142.      <ctrl> F5 : Play the default voc-sample file.
  143.  
  144.      <ctrl> F6 : Play the default cmf-sound file.
  145.  
  146.      <ctrl> F7 : Play the default pcx-image file.
  147.  
  148.      <ctrl> F8 : Play the default bmp-image file.
  149.  
  150.      <ctrl> F9 : Play the default gif-image file.
  151.  
  152.      <ctrl> F10: Play the default tga-image file.
  153.  
  154.     <shift> F1 : Play the default wpg-image file.
  155.  
  156.     <shift> F2 : Play the default rix-image file.
  157.  
  158.     <shift> F3 : Play the default mac-image file.
  159.  
  160.     <shift> F4 : Play the default ico-icon file.
  161.  
  162.     == Multi ==
  163.  
  164.       <alt> F1 : Play the default pcx-image with mod-sound file.
  165.  
  166.       <alt> F2 : Play the default bmp-image with mod-sound file.
  167.  
  168.       <alt> F3 : Play the default gif-image with mod-sound file.
  169.                Note : The .MOD file is gonna be played when decoding
  170.                      of the .GIF image is done. This because I needed
  171.                 the memory for decoding the image...
  172.  
  173.       <alt> F4 : Play the default tga-image with mod-sound file.
  174.  
  175.       <alt> F5 : Play the default pcx-image with voc-sample file.
  176.  
  177.       <alt> F6 : Play the default bmp-image with voc-sample file.
  178.  
  179.       <alt> F7 : Play the default gif-image with voc-sample file.
  180.                Note : Yes, together !!!
  181.  
  182.       <alt> F8 : Play the default tga-image with voc-sample file.
  183.  
  184.       <alt> F9 : Play the default pcx-image with cmf-sound file.
  185.  
  186.       <alt> F10: Play the default bmp-image with cmf-sound file.
  187.  
  188.     <shift> F5 : Play the default gif-image with cmf-sound file.
  189.              Note : Together.
  190.  
  191.     <shift> F6 : Play the default tga-image with cmf-sound file.
  192.  
  193.     == Output ==
  194.  
  195.     <shift> F9 : 'Video Output' menu.
  196.  
  197.     <shift> F10: 'Sound Output' menu.
  198.  
  199.       <alt> X  : Quit MMM.
  200.  
  201.     TECHNICAL..:
  202.     ----------------------------------------------------------------------
  203.     I've used the Borland C++ 3.1 compiler to create this program and I've
  204.     used the Turbo Vision abilities for the menu. The MOD, MDI-modules
  205.     were created in assembly, the FLI player in C, the rest in C++.
  206.  
  207.     I have used the VESA standard for the SVGA video-modes, so there
  208.     shouldn't be any problem using this program on any type of SVGA-card.
  209.  
  210.     The '.MOD & .GIF' option works different than the other '.MOD & .???'
  211.     options, because I needed the heap to decode the .GIF and when that's
  212.     done, the .MOD file is gonna be played, so don't blame me...
  213.  
  214.     For the .VOC player the CT-VOICE.DRV is needed. MMM searches the
  215.     dos-path for this file and then loads the driver into the memory.
  216.     I know that there's a setting in use like : SET SOUND=C:\DOS, but
  217.     usually your path is to that same directory and it's easier to
  218.     search the path than to search via the environment setting.
  219.  
  220.     The .CMF player uses the SBFMDRV.COM. This driver used to be in
  221.     your Sound Blaster - Sound Blaster Pro package. You can test this
  222.     driver by using 'Info' -> 'Check SBFMDRV.COM'.
  223.  
  224.     CREATOR....:
  225.     ----------------------------------------------------------------------
  226.         Edward C. Willemsen,
  227.         Hordenweg 9,
  228.         3961 KA Wijk bij Duurstede,
  229.         Exed-software, 1994 (c++),
  230.         The Netherlands.
  231.  
  232.     You can show your gratitude on this account in
  233.     The Netherlands : 36.70.45.370 ( RABO ). If you wanna report a bug,
  234.     or wanna have a new version or even the source code, then
  235.     show your gratitude and fill in your address or phone number on the
  236.     account space. You may even send me a post card if you like.
  237.     
  238.     You can leave a message on the following B.B.S. number in
  239.     The Netherlands :
  240.  
  241.             Euro Disney BBS (+31) 077-871634,
  242.                       Venlo
  243.                   Syzo : Daniël Korsten
  244.  
  245.     Perhaps you have a great idea or a nice source.
  246.  
  247.     LAY-OUT....:
  248.     ----------------------------------------------------------------------
  249.     ≡ ──────┐
  250.         │
  251.         ├───────────────┐
  252.         │ Text size  F1 │
  253.         │ Dos shell  F2 │
  254.         ├───────────────┤
  255.         │ About         │    a)
  256.         └───────────────┘
  257.  
  258.     File ───┐
  259.         │
  260.         ├──────────────────┐
  261.         │ Open .DL         │
  262.         │ Open .FLI        │
  263.         │ Open .MOD        │
  264.         │ Open .MDI        │
  265.         │ Open .VOC        │
  266.         │ Open .CMF        │
  267.         │ Open .PCX        │
  268.         │ Open .BMP        │
  269.         │ Open .GIF        │
  270.         │ Open .TGA        │
  271.         │ Open .WPG        │
  272.         │ Open .RIX        │
  273.         │ Open .MAC        │
  274.         │ Open .ICO        │
  275.         ├──────────────────┤
  276.         │ Change dir... F3 │
  277.         ├──────────────────┤
  278.         │ Exit       Alt-X │
  279.         └──────────────────┘
  280.  
  281.     Play ───┐
  282.         │
  283.         ├──────────────────┐
  284.         │ .DL         ^F1  │
  285.         │ .FLI        ^F2  │
  286.         │ .MOD        ^F3  │
  287.         │ .MDI        ^F4  │
  288.         │ .VOC        ^F5  │
  289.         │ .CMF        ^F6  │
  290.         │ .PCX        ^F7  │
  291.         │ .BMP        ^F8  │
  292.         │ .GIF        ^F9  │
  293.         │ .TGA        ^F10 │
  294.         │ .WPG   Shift F1  │
  295.         │ .RIX   Shift F2  │
  296.         │ .MAC   Shift F3  │
  297.         │ .ICO   Shift F4  │
  298.         └──────────────────┘
  299.  
  300.     Multi ──┐
  301.         │
  302.         ├────────────────────────┐
  303.         │ .PCX & .MOD    Alt F1  │
  304.         │ .BMP & .MOD    Alt F2  │
  305.         │ .GIF & .MOD    Alt F3  │
  306.         │ .TGA & .MOD    Alt F4  │
  307.         ├────────────────────────┤
  308.         │ .PCX & .VOC    Alt F5  │
  309.         │ .BMP & .VOC    Alt F6  │
  310.         │ .GIF & .VOC    Alt F7  │
  311.         │ .TGA & .VOC    Alt F8  │
  312.         ├────────────────────────┤
  313.         │ .PCX & .CMF    Alt F9  │
  314.         │ .BMP & .CMF    Alt F10 │
  315.         │ .GIF & .CMF  Shift F5  │
  316.         │ .TGA & .CMF  Shift F6  │
  317.         └────────────────────────┘
  318.  
  319.     Output ─┐
  320.         │
  321.         ├───────────────────────────┐
  322.         │ Video settings  Shift F9  │    b)
  323.         │ Sound settings  Shift F10 │    c)
  324.         ├───────────────────────────┤
  325.         │ Mixing speed              │    d)
  326.         └───────────────────────────┘
  327.  
  328.     Info ───┐
  329.         │
  330.         ├───────────────────────────┐
  331.         │ Default file(s)           │
  332.         ├───────────────────────────┤
  333.         │ Check VESE/SVGA abilities │
  334.         │ Check Sound Blaster       │
  335.         │ Check Adlib Card          │
  336.         │ Check SBFMDRV.COM         │
  337.         │ Check free Memory         │
  338.         │ Check Processor(s)        │
  339.         └───────────────────────────┘
  340.  
  341.     Reset ──┐
  342.         │
  343.         ├─────────────────┐
  344.         │ Default file(s) │
  345.         │ Screen desktop  │
  346.         │ Computer        │
  347.         └─────────────────┘
  348.  
  349.         a)    ┌[■]─────Information─────────┐
  350.             │                            │
  351.             │  Multi Media Machine 2.3ß  │
  352.             │       E.C. Willemsen       │
  353.             │  Exed-software 1994 (c++)  │
  354.             │                            │
  355.             │           [ ok ]           │
  356.             │                            │
  357.             └────────────────────────────┘
  358.  
  359.         b)    ┌[■]──────Video Output─────────┐
  360.             │                              │
  361.             │ Resolutions :                │
  362.             │                              │
  363.             │ (∙) MCGA/VGA    320x 200x256 │
  364.             │ ( ) VESA/SVGA   640x 400x256 │
  365.             │ ( ) VESA/SVGA   640x 480x256 │
  366.             │ ( ) VESA/SVGA   800x 600x256 │
  367.             │ ( ) VESA/SVGA  1024x 768x256 │
  368.             │ ( ) VESA/SVGA  1280x1024x256 │
  369.             │                              │
  370.             │    [ ok ]       [ cancel ]   │
  371.             │                              │
  372.             └──────────────────────────────┘
  373.  
  374.         c)    ┌[■]──────────Sound Output────────────┐
  375.             │                                     │
  376.             │ Devices :                           │
  377.             │                                     │
  378.             │ (∙) P.C. Speaker                    │
  379.             │ ( ) Covox on LPT 1                  │
  380.             │ ( ) Covox on LPT 2                  │
  381.             │ ( ) Covox on LPT 3                  │
  382.             │ ( ) Covox on LPT 1 & LPT 2 (stereo) │
  383.             │ ( ) Covox on LPT 1 & LPT 2 (mono)   │
  384.             │ ( ) Sound Blaster                   │
  385.             │ ( ) Sound Blaster Pro               │
  386.             │ ( ) Disney Sound LPT 1              │
  387.             │                                     │
  388.             │        [ ok ]       [ cancel ]      │
  389.             │                                     │
  390.             └─────────────────────────────────────┘
  391.  
  392.         d)    ┌[■]─────Mixing Speed────────┐
  393.             │                            │
  394.             │ Speeds :                   │
  395.             │                            │
  396.             │ (∙) 10.000 Hz (default)    │
  397.             │ ( ) 11.000 Hz              │
  398.             │ ( ) 12.000 Hz              │
  399.             │ ( ) 13.000 Hz              │
  400.             │ ( ) 14.000 Hz (386)        │
  401.             │ ( ) 15.000 Hz              │
  402.             │ ( ) 16.000 Hz (486)        │
  403.             │ ( ) 17.000 Hz              │
  404.             │ ( ) 18.000 Hz              │
  405.             │                            │
  406.             │    [ ok ]     [ cancel ]   │
  407.             │                            │
  408.             └────────────────────────────┘
  409.  
  410.     BY THE WAY.:
  411.     ----------------------------------------------------------------------
  412.     MMM version 2.3 is freeware, so copy it to all you're friends and
  413.     show all together your gratitude. The money is gonna be used to
  414.     develop a new version with more abilities like ........ hmmm...
  415.     ... what's next ?
  416.  
  417.     WARNING....:
  418.     ----------------------------------------------------------------------
  419.     Do not use this program with other clocktick using, memory resident,
  420.     heap filling, undefined    programs !!! This could reboot your computer.
  421.  
  422.     THANX 2 :
  423.     ----------------------------------------------------------------------
  424.         Jim Kent..................................FLI;
  425.         Mark J. Cox...............................MOD;
  426.         Gershon Elber.............................GIF;
  427.         Chris Harris........................DOX DEBUG;
  428.         Rodney van den Oever...............TIPS/HINTS;
  429.         Edward C. Willemsen.......THE COMPLETE CODING.
  430.  
  431.     BUGS :
  432.     ----------------------------------------------------------------------
  433.     This is the first version of 'MMM 2.3', so I expect that the
  434.     code is not 100% bugfree, but there aren't any bugs found
  435.     yet...
  436.  
  437.     Greetings from Edward C. Willemsen...
  438.  
  439.